home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dbase / dbb22.zip / DBB.DOC next >
Text File  |  1989-10-04  |  7KB  |  139 lines
  1.                     dBB (DataBase Browser) Version 1.2
  2.                           Copyright (C) 1988,1989
  3.                                  H. A. Fox
  4.  
  5. This program is NOT public domain software. It is, nonetheless, provided
  6. free of charge for all private, non-commercial use. However, if you find
  7. dBB useful and would like to support the continued development of it and
  8. other useful utilities (as well as the Shareware software system, in
  9. general), you are encouraged to send a contribution of any amount to:
  10.  
  11.      H. A. Fox
  12.      P. O. Box 10036
  13.      Daytona Beach, FL 32120
  14.  
  15. Contributions of ten dollars ($10) or more will allow me to notify you of
  16. any future releases (which will be offered at a very nominal cost). Many
  17. additional features and capabilities are planned for dBB but interest shown
  18. by support will ultimately determine its future.
  19.  
  20. If you use this software in a commercial environment or would like to
  21. distribute it as part of another software system you MUST contact the
  22. author for licensing terms either at the above address or by EasyPlex to
  23. 70741,3602. Source code will be available in the future for a fee.
  24.  
  25. dBB is offered with no warranties, expressed or implied, and responsibility
  26. for its use lies solely with the individual user. I will, nonetheless,
  27. attempt to correct any problems with the program when reported by
  28. registered users. (If you don't want to pay, fine. Just be happy with what
  29. you've got.)
  30.  
  31. You are free to copy dBB and pass it along to friends and co-workers as
  32. long as you don't charge them anything for it. If you do make copies,
  33. please be sure the program is distributed with this small documentation
  34. file.
  35.  
  36. dBASE is a registered trademark of Ashton-Tate.
  37.  
  38. Description:
  39.      dBB is a program that simulates the dBASE(tm) BROWSE command and
  40. allows dBASE III or III Plus files to be viewed (BUT NOT EDITED) without
  41. the need to run dBASE. It can browse files of any size and includes
  42. commands to scroll fields horizontally in much the same way as dBASE. It
  43. also provides a structure display which can be viewed at any time. There is
  44. no support for memo fields other than displaying them as simply 'Memo'.
  45. Neither does dBB support the use of indexes while viewing databases. dBB
  46. does properly handle character fields of any length. dBB sports few
  47. elaborate features but is small and good at what it does. It is especially
  48. useful when used in conjunction with DOS shells and file managers that
  49. allow the use of external programs for operating on selected files.
  50.  
  51. Operation:
  52.      dBB is very simple to use. From the DOS prompt enter the command:
  53.  
  54.                            DBB <filename>[<.ext>]
  55.  
  56. where <filename> is the name of the dBASE III file to be browsed and <.ext>
  57. is an optional file extension. If no extension is given dBB assumes the
  58. standard dBASE 'DBF' extension. A path is optional if the file is not in
  59. the current directory but dBB will not resolve ambiguous pathnames (ie.
  60. those that use '.' and '..'). Please see 'Technical Notes' below for other
  61. command line parameter information.
  62.      If the file is found, dBB will show the first 21 records of the file
  63. fitting as many fields as possible on the screen. Field display and column
  64. widths are exactly as in dBASE; field names are never truncated. The top
  65. line of the screen is a status line that shows the selected filename, the
  66. date the file was last updated, the record number of the first record being
  67. displayed and the total number of records in the file. If the file is empty
  68. (no records) the status line will indicate such and the file structure will
  69. be automatically displayed. The bottom two lines of the display show the
  70. keys that can be used to view the database. Here also is a summary of
  71. available commands (The '^' symbol indicates the <Ctrl> key):
  72.  
  73.      <Up> and <Down> cursor keys-
  74.           Scrolls the display to the next or previous record.
  75.  
  76.      <PgUp> and <PgDn>-
  77.           Displays the next or previous 20 records in the file.
  78.  
  79.      <^PgUp> and <^PgDn>-
  80.           Moves to the first or last record in the file respectively.
  81.  
  82.      <Left> and <Right> cursor keys-
  83.           Scrolls the field display one field to the left or right.
  84.  
  85.      <^Left> and <^Right>-
  86.           'Pages' the field display to the left or right multiple fields.
  87.  
  88.      <Home> and <End>-
  89.           Repositions the field display to the first and last fields of the
  90.           structure respectively.
  91.  
  92.      <^Home> and <^End>-
  93.           Combines the effects of the <Home> and <^PgUp> keys, and the
  94.           <End> and <^PgDn> keys.
  95.  
  96.      <S>-
  97.           Invokes the file structure display. Large structures can be
  98.           viewed with <Up>, <Down>, <PgUp>, <PgDn>, <Home> and <End>. To
  99.           return to the record display, press <Esc>, <Q>, or <X>.
  100.  
  101.      <Esc>-
  102.           Exits dBB and returns to the DOS prompt leaving the browse
  103.           display on the screen.
  104.  
  105.      <Q>-
  106.           Exits and returns to DOS clearing the screen in the process.
  107.  
  108.      <X>-
  109.           Exits and returns to DOS restoring the screen to its contents
  110.           just prior to running dBB.
  111.  
  112. Please note that when scrolling records with any of the above commands, dBB
  113. will always show as many records as possible.
  114.  
  115. Technical notes:
  116.      This version of dBB does no internal buffering of the browsed file.
  117. Consequently, it reads the file each and every time that the browse display
  118. is changed in any way. This enables dBB to handle the largest possible file
  119. but, obviously, leads to a large number of disk operations. This, in turn,
  120. can result in some pretty mediocre performance on anything other than a
  121. '286 or '386 machine with a relatively fast hard disk and/or a good disk
  122. cacheing program. I definitely don't recommend the use of dBB on floppy
  123. based systems. This is one of those enhancements that is planned and/or in
  124. the works, the completion of which depends on interest and support.
  125.      dBB supports all text modes and most any type of display
  126. adapter/monitor combination. If you use a composite color display setup you
  127. must use the command line parameter '/B' or ('/b') to force dBB into black
  128. and white mode. If used, this paramater must appear as the last entry on
  129. the command line and must be separated by at least one space from the rest
  130. of the command line. If you would like to make this the operational default
  131. of dBB (so you don't have to use the parameter every time) you can contact
  132. me via EasyPlex and I will forward the necessary information that will
  133. enable you to patch the program accordingly.
  134.  
  135. I hope you find dBB a useful addition to your utility library.
  136.  
  137.          ----------------end-of-author's-documentation---------------
  138.  
  139.